NOTE: The key derivation is left for the script to do

NOTE: The key is not a pass{word,phrase}

See also: http://www.di-mgt.com.au/cryptokeys.html#passwordpassphraseandkey

The purpose of this option is to make sure that the data is encoded to unicode (UTF-8) before any of it is parsed and returned to the application using libquvi.

By default, libquvi converts the data which is in the encoding used for the strings by the C runtime in the current locale into UTF-8. IF this fails, and the from charset option is set, the library will then try to convert to UTF-8 using the from charset value.

See also libcurl-tutorial(3) which covers the use of cookies with the library in greater detail.

The second argument (qoo) is expected to be a dictionary of additional quvi object options, if defined at all.

The function will return the base64 value in the dictionary.

The function will return the plaintext value in the dictionary. The value is returned in hexadecimal form.

The availability of the algorithms is determined by libgcrypt, and how it was built

The second argument (qoo) is expected to be a dictionary containing the cipher options.

The function will return the ciphertext value in the dictionary. The value is returned in hexadecimal form.

The second argument (qoo) is expected to be a dictionary containing the cipher options.

The function will return the plaintext value in the dictionary. This value is returned in hexadecimal form.

The second argument (qoo) is expected to be a dictionary containing the hash options, e.g. the algorithm that should be used.

The function will return the digest value in the dictionary. The value is returned in hexadecimal form.

The second argument (qoo) is expected to be a dictionary containing the cookie options, e.g. the cookie mode that should be used.

The complete list of the available cookie modes can be found in the quvi/const module of the quvi-modules(7). The mode names are named after their equivalent CURLOPT_COOKIE{SESSION,FILE,LIST,JAR} variable names. For a description of each option, see libcurl_easy_setopt(3).

This function will not return any additional values in the dictionary.

libquvi will ignore any calls to quvi.http.cookie unless QUVI_OPTION_ALLOW_COOKIES is QUVI_TRUE

libcurl will parse the received cookies and use them in the subsequent HTTP requests only if libquvi QUVI_OPTION_ALLOW_COOKIES is QUVI_TRUE

The second argument (qoo) is expected to be a dictionary of additional quvi object options, if defined at all.

The function will return the data value among the values in the returned dictionary.

The second argument (qoo) is expected to be a dictionary of additional quvi object options, if defined at all.

This function essentially wraps CURLOPT_HTTPHEADER, and will not return any additional values in the dictionary. See curl_easy_setopt(3) for the full description of CURLOPT_HTTPHEADER.

To clear the custom headers, pass "" as the VALUE; the custom headers are also cleared automatically when a support script function parse is called

The second argument (qoo) is expected to be a dictionary of additional quvi object options, if defined at all.

The function will return the content_length and the content_type values among the values in the returned dictionary.

The second argument (qoo) is expected to be a dictionary of additional quvi object options, if defined at all.

The function will return the resolved_url among the values in the returned dictionary. If the URL did not redirect to another location, the value of the resolved_url is left empty.

local r = quvi.http.fetch('http://example.com')

r.data would now hold the contents. If an error occurred, e.g. connection failed, the library would exit the process with an error.

local C = require 'quvi/const'
local o = { [C.qoo_croak_if_error] = false }
local r = quvi.http.fetch('http://example.com', o)
if r.quvi_code ~= C.qerr_ok then


  local s =


    string.format('quvi.http.fetch: %s (libquvi=%d, http/%d)',


                  r.error_message, r.quvi_code, r.response_code)


  error(s)
end

By setting qoo_croak_if_error to false, we tell the library to only register that an error occurred and return the control to the script. Handling of the error is then left for the script to do.